 Wargus v2.2.4 GP2X Port: Warcraft II by Adventus

Overview:

	This is a port of Wargus for GP2X, an engine re-implementation of warcraft II 
	based on the Stratagus v2.2.4 engine. 
	
	It's a bit tricky to install so be patient and post on the gp32x forums if you 
	have trouble. If at any point the game does not work look at the "stderr.txt" 
	and "stdout.txt" files for clues, they're generally pretty informative.
	
Notes:
	
	- Beta Testers have been experiencing some saving inconsistancies, so far i have 
	been unable to track down the problem. From my experience it seems to only screw 
	up when you haven't built any buildings beyond what is initially on the map. 
	So, for now, make sure you've built a building before you attempt to save.
	
	- Loading the campaign screen with the scrolling text can take a little while, 
	maybe 30 sec, so don't assume its crashed.
	
	- If the screen begins flickering (and it bothers you) goto preferences and move 
	the game speed slider down. It seems to be related to attempting to updating the 
	screen too fast for the graphics system to keep up with.
	
	- There are some inconsistancies with the objectives and what the actually need 
	to finish a map. Usually when this occurs you just need to kill all the enemy
	units. 
	
Installation:

	1. Make sure you have the Dos Edition of Warcraft 2, Battlenet edition DOES NOT 
	   work. 
	
	2. Download and install the correct ImageMajick version for your OS from:
	
	   http://www.imagemagick.org/script/binary-releases.php
	
	3. Download and install Wargus onto your computer. Get Wargus from:
		
	   http://wargus.sourceforge.net/download.shtml
	
	   Play it to make sure it extracted all the resources properly. 
	
	4. Goto your Wargus install directory and copy the following directories to 
	   somewhere else on your harddrive:
		
		- data/campaigns
		- data/graphics
		- data/maps
	
	NB: Maintain the same structure, aka have a "data" folder with the "campaigns",
	    "graphics" and "maps" folders inside.
	
	5. From this release copy the "HalfSample.txt" script and rename appropiate to 
	   your OS (AKA .bat for Windows, etc) to the "data" folder made in step 4.
	   Run script. This script uses ImageMajick via the commandline to resize all 
	   the warcraft 2 images by 50%.
		
	6. Extract the files/folders from this release and copy to a folder on your 
	   SD card. Copy the modified "data" folder you produced in step 3 & 4 to your 
	   SD card. This should result in the following structure:
	
		- ./scripts				(folder)
	    - ./data				(folder)
		- ./2xWargus224
		- ./2xWargus224.gpe
		- ./2xWargus224.png		(Thanks Gruso)
		- ./vsmall.png
		
	7. On your GP2X run "Wargus224.gpe".... and hope like hell it worked. XD.

Command Line Arguments:

-stdlog			: Outputs stdout and stderr to files. Reccomended when first 
				  installing, not required once install seems stable.
-keymap n		: n Specifies which keymap (see below) is used at startup.
				  Default value = 0
-dpadacc n		: n Specifies the dpad-mouse acceleration.
				  Default value = 100
-dpadmaxv n		: n Specifies dpad-mouse maximum velocity.
				  Default value = 100	
-scrollspd n	: n Specifies the scrolling rate.
				  Default value = 100
				  
Controls: F100 Non Touchscreen:
+===============+===============================+===============================+
|Button			|Keymap 0, Scroll Lock			|keymap 1, Scroll Assigned      |
+===============+===============================+===============================+
|Joystick Up	|Move Mouse up/Scroll Up		|Move Mouse up					|
|Joystick Down	|Move Mouse down/Scroll Down	|Move Mouse Down				|
|Joystick Left	|Move Mouse left/Scroll Left	|Move Mouse Left				|
|Joystick Right	|Move Mouse right/Scroll Right	|Move Mouse Right				|
|Button Y		|Up One level in Commandbox		|Scroll Up						|
|Button B		|Left Mouse button				|Scroll Right					|
|Button X		|Right Mouse button				|Scroll Down					|
|Button A		|Use item in Commandbox			|Scroll Left					|
|Button L		|Hold for Scrolling				|Left Mouse Button				|
|Button R		|Hold for Scrolling				|Right Mouse Button				|
|Volume +		|Next item in commandbox		|N/A							|
|Volume - 		|Previous item in commandbox	|N/A							|
|Start			|Open/Close Menu				|Open/Close Menu				|
|Select			|Change Keymap					|Change Keymap					|
+===============+===============================+===============================+

Controls: F200 Touchscreen:
+===============+===============================+===============================+
|Button			|Keymap 2, Right Handers		|keymap 3, Left Handers 	 	|
+===============+===============================+===============================+
|Joystick Up	|Scroll Up						|N/A							|
|Joystick Down	|Scroll Down					|N/A							|
|Joystick Left	|Scroll Left					|N/A							|
|Joystick Right	|Scroll Right					|N/A							|
|Button Y		|N/A							|Scroll Up						|
|Button B		|N/A							|Scroll Right					|
|Button X		|N/A							|Scroll Down					|
|Button A		|N/A							|Scroll Left					|
|Button L		|Left Mouse button				|N/A							|
|Button R		|N/A							|Left Mouse Button				|
|Volume +		|Right Mouse button				|Open/Close Menu				|
|Volume - 		|Right Mouse button				|Change Keymap					|	
|Start			|Open/Close Menu				|Right Mouse button				|
|Select			|Change Keymap					|Right Mouse button				|
+===============+===============================+===============================+

Changelog Public Beta 1.3:
- Added updated SDL, touchscreen now much smoother. Thanks Senor_Quack. 
- Released Sourcecode.

Changelog Public Beta 1.2:
- No longer saves anything to NAND.... i mean it this time. 
- Added Command Selector for keymap 0 (Vol +/-, A and Y).
- Made cursor movement independant of fps (via Delta time).
- Adjusted default commandline arguments. Too fast for some.
- Fixed Some UI elements (Added Mana... Removed XP)
- Recompiled. Smaller filesize, maybe a little bit smoother.
- Added Gmenu icon. Thanks Gruso.

Changelog Public Beta 1.1:
- Fixed HoME directory, no longer saves to NAND.... Woops. :) 
- Fixed Command line arguments.
- Changed default preferences.
- Added R button scroll lock for keymap 0.

Changelog Public Beta 1:
- Resized all UI elements in Lua to fit 320x240. 
- Modified Units for new sprite size.
- Removed some menu options (Multiplayer, sound, replay, etc).
- Modified SDL to use upper 32mb Hardware surfaces for all sprites except fonts. 
  Uses Hardware Blitter.
- Wrote GP2X input system. Generic implementation, simulates SDL events within 
  the engine instead of trying to handle them directly.
- Wrote texture resizing script.

Credits:
Gp2X Port:			Adventus 		contact via "lachlan_ts@hotmail.com"
Stratagus engine:	Lutz Sammer, Fabrice Rossi, Vladi Shabanski, Patrice Fortier, 
					Jon Gabrielson, Andreas Arens, Nehal Mistry, Jimmy Salmon, and 
					others.	http://stratagus.org.
Wargus:				Jimmy Salmon, Russell Smith, Nehal Mistry, Joris Dauphin, 
					Martin Renold, Carlos Perello Marin, Pludov, Andreas 'Ari' Arens,
					Lutz 'Johns' Sammer, Edgar 'Froese' Toernig, Crestez Leonard, 
					Mark Pazolli, Valery Shchedrin, Iftikhar Rathore, Charles K Hardin ,
					Fabrice Rossi, DigiCat, Josh Cogliati, Patrick Mullen,
					Vladi Belperchinov-Shabanski, Cris Daniluk, Patrice Fortier, 
					FT Rathore, Trent Piepho, Jon Gabrielson, Lukas Hejtmanek, 
					Steinar Hamre, Ian Farmer, Sebastian Drews, Jarek Sobieszek,
					Anthony Towns, Stefan Dirsch, Al Koskelin, George J. Carrette,
					Dirk 'Guardian' Richartz, Michael O'Reilly, Dan Hensley, 
					Sean McMillian, Mike Earl, Ian Turner, David Slimp, Iuri Fiedoruk,
					Luke Mauldin, Nathan Adams, Stephan Rasenberger, Dave Reed,
					Josef Spillner, James Dessart, Jan Uerpmann, Aaron Berger,
					Latimerius, Antonis Chaniotis, Samuel Hays, David Martinez Moreno,
					Flavio Silvestrow, Daniel Burrows, Dave Turner, Ben Hines, 
					Kachalov Anton ,Martin Hajduch, Jeff Binder, Ludovic, Juan Pablo,
					Phil Hannent, Alexander MacLean.... (pff is that all)
		